home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
ada
/
gwuada_9.zip
/
README
< prev
next >
Wrap
Text File
|
1992-10-05
|
24KB
|
527 lines
1. INTRODUCTION.
This file is the README file from the distribution of Ada/Ed version
1.11.1-PC, an Ada interpreter for 386/486 machines running MS-DOS/PC-DOS.
The distribution consists of a single compressed tar file
and is available through anonymous ftp on cs.nyu.edu (128.122.140.24)
in the directory pub/adaed. The distribution contains sources and
executables. The ftp directory contains another distribution for
Unix-based machines.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Purpose License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version. See relevant excerpts below.
Ada/Ed is a translator-interpreter for Ada. It is intended as a teaching
tool, and does not have the capacity, performance, or robustness of
commercial Ada compilers. Ada/Ed was developed at New York University, as
part of a long-range project in language definition and software prototyping.
The project produced the first validated translator for Ada, in the form of
an executable definition of the language written in SETL. The SETL system
served as design document and prototype for the C version being released today.
Ada/Ed was last validated under version 1.7 of the ACVC tests. Therefore it is
not currently a validated Ada system, and users can expect to find small
discrepancies between Ada/Ed and currently validated compilers.
Apart from the 100-odd tests of ACVC 1.11 that Ada/Ed currently fails, the
major deficiency of the system is that, being an interpreter, it does not
implement most representation clauses, and thus does not support systems
programming close to the machine level.
We trust that even with these limitations, Ada/Ed will be of use to the
Ada community at large: students, educators, user, and implementors. The
sources of the system should be of interest to compiler writers, and we hope
that they will encourage the construction of software tools to make the system
more usable and polished. The NYUADA project does not have the resources to
promise regular new maintenance releases of the software, but will do its
best to keep track of reported errors, workarounds, and fixes. We will also
produce at irregular intervals design notes and additional documentation on
the front-end of the system. We urge users to send comments, corrections
and bug reports (reduced to their simplest form!) to: adaed@cs.nyu.edu
All users of Ada/Ed are urged to register themselves by
sending email to the above address, or to the NYUADA project, New
York University, 251 Mercer Street, New York, NY 10012. This will allow us to
notify users of updates and new releases of the system.
2. (UN) WARRANTY
This software is release 1.11.1-PC of the Ada/Ed system.
It is distributed absolutely WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
To receive a copy of the GNU General Public License write to the Free
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139.
The following is an excerpt from the GNU General Public License concerning
warranties:
Because the program is licensed free of charge, there is no warranty
for the program, to the extent permitted by applicable law. Except when
otherwise stated in writing the copyright holders and/or other parties
provide the program "as is" without warranty of any kind, either expressed
or implied, including, but not limited to, the implied warranties of
merchantability and fitness for a particular purpose. The entire risk as
to the quality and performance of the program is with you. Should the
program prove defective, you assume the cost of all necessary servicing,
repair or correction.
In no event unless required by applicable law or agreed to in writing
will any copyright holder, or any other party who may modify and/or
redistribute the program as permitted above, be liable to you for damages,
including any general, special, incidental or consequential damages arising
out of the use or inability to use the program (including but not limited
to loss of data or data being rendered inaccurate or losses sustained by
you or third parties or a failure of the program to operate with any other
programs), even if such holder or other party has been advised of the
possibility of such damages.
3. INSTALLATION
To intall Ada/Ed choose a directory to contain the executables and
library files; include this directory on the PATH; set the environment
variable ADAED to the pathname for this directory; and copy the files
*.exe, predef.axq, predef.trc, and predef.lib into the directory.
For example, if the directory chosen is C:\ADAED, then the AUTOEXEC.BAT
might contain lines such as:
PATH=C:;C:\ADAED
SET ADAED=C:\ADAED
Try some of the supplied demo program (see the readme in the demos directory)
Also look at the release.notes for more information about the system and
the changes that have take place.
4. REBUILDING
Ada/Ed is written in C, and built using Intel's 386/486 C Code Builder.
The sources and makefile for doing this are part of the distribution. To
rebuild, read the makefile and execute "make" and "make predef.lib" or
just "make predef.lib". In particular, note the comment in the makefile
about the include file makeext. After rebuilding, follow the installation
instructions above.
5. USING Ada/Ed
The Ada/Ed system includes the following commands:
adacomp [ -abgsv ] [ -m main_unit ] [ -n ] [-l library ] file
adabind [ -m main_unit ] [-l library]
adaexec [ -h heap] [ -m bound_main_unit ] [-p pstack] [-s tstack]
[ -r nb_stmts] [ -t [acerst] ] [-l library]
adalib [-l library]
Description
Ada/Ed is a translator/interpreter for the Ada programming language that
is intended primarily for educational use.
Adacomp compiles an Ada program; it invokes in succession the two
compilation phases: parsing and semantic analysis (the front end) ,and
code generation. The file argument refers to the source file; if no
extension is given for it, the extension ADA is assumed. The file argument
may contain drive and directory specifications. The output of the compiler
is an instruction stream for an abstract Ada machine, which is then
interpreted.
Adabind binds a given library with the specified main unit to form an
executable program.
Adaexec invokes the Ada machine interpreter for the bound program given in
the specified library.
Adalib displays the contents of the specified library.
Note : All options must precede the file name and may be in either lower or
upper case.
Program Library
All compilations require a library. A library is a directory, which is
created or reinitialized when the user invokes a command containing a -n
option such as:
adacomp -n -l libname adafile
Intermediate files appear in directory libname. This directory is created by
the command if it does not already exist. Only the listing files are created
in the directory from which adacomp is invoked. The libname directory should
only be used to hold files created by the adacomp command (i.e. those
produced by the Ada/Ed system); confusion and grief may result if you attempt
to use a library directory to hold other files. The libname argument may
contain drive and path specifications.
The libname argument can be omitted if the environment variable ADALIB is
defined. For example, if you are doing several compilations referring to
the same library you can use the command
SET ADALIB=C:\MYLIB
to indicate the library to be used. In this way the -l option (including
its library name argument) to adacomp, adabind, adaexec and adalib can be
omitted.
A given utility library UL (e.g. one that contains mathematical functions)
may be used by several unrelated programs. It may then be convenient to
create independent libraries for each program, and i